home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / fido / MMAreaFixPlus.lha / DOC / MM_AreaFixPlus.DOC
Text File  |  1995-07-07  |  15KB  |  459 lines
  1.  
  2. MM--------------------------------------------------------------------------
  3.    ##   #####  ######   ##   ######  #  #    # #####  #      #    #  #### 
  4.   #  #  #    # #       #  #  #       #   #  #  #    # #      #    # #     
  5.  #    # #    # #####  #    # #####   #    ##   #    # #      #    #  #### 
  6.  ###### #####  #      ###### #       #    ##   #####  #      #    #      #
  7.  #    # #   #  #      #    # #       #   #  #  #      #      #    # #    #
  8.  #    # #    # ###### #    # #       #  #    # #      ######  ####   #### 
  9. ----------------------------------------------------------------------------
  10.  
  11.                       (C) 1994-95 By Paolo Carotenuto
  12.  
  13.  
  14. * WHAT IS MM_AREAFIXPLUS
  15. -------------------------
  16.  
  17. AreaFix is designed to receive messages from nodes/points in
  18. order that they may change which echoes they are receiving from
  19. you.
  20.  
  21.  
  22.  
  23.  
  24. * HOW TO INSTALL MM_AREAFIX+
  25. -----------------------------
  26.  
  27. Keywords in the config file:
  28.  
  29.  
  30.  
  31. #AUTOEXPORT ON/OFF  (Default OFF)
  32. ~~~~~~~~~~~~~~~~~~
  33.  
  34. ON  - MM_AreafixPlus does an export.
  35.  
  36. OFF - MM_AreafixPlus does NOT an export.
  37.  
  38.  
  39.  
  40.  
  41. #PROCESSPASSTHRO ON/OFF  (Default OFF)
  42. ~~~~~~~~~~~~~~~~~~~~~~~
  43.  
  44. ON  - MM_AreaFixPlus checks PASSTRHOU areas (see #CHECKPASSTHRO)
  45.  
  46. OFF - MM_Areafix does NOT check PASSTHROU areas
  47.  
  48.  
  49.  
  50.  
  51. #AUTOPOLICY <ON/OFF>  (Default = OFF)
  52. ~~~~~~~~~~~~~~~~~~~~
  53.  
  54. If ON MM_AreafixPlus send automagically, when linking an area, also her policy
  55. if available.
  56.  
  57.  
  58.  
  59.  
  60. #CHECKPASSTHRO
  61. ~~~~~~~~~~~~~~
  62.  
  63. If it is set, MM_Areafix will check all passthrough areas in your system and if find one with ONLY one node linked, send after <n> days a message to your configured uplink.
  64.  
  65. The right syntax is:
  66.  
  67. #CHECKPASSTHRO     <node 5D>         <Password>    <Days>
  68.                       |                  |           |
  69. Your uplink ----------|                  |           |
  70.                                          |           |
  71. Password for areafix of your uplink------|           |
  72.                                                      |
  73. n. of days to wait before sending msg to areafix-----|
  74.  
  75. Example:
  76.  
  77. #CHECKPASSTHRO   2:335/4.0@fidonet        BIG          3
  78.  
  79.  
  80.  
  81.  
  82. #BOSSNODE
  83. ~~~~~~~~~
  84.  
  85. Your Boss where to send automatic requests for your SpecialNodes.
  86.  
  87. The right syntax is:
  88.  
  89. #BOSSNODE    <Node 5d>          <Path/name>           <Password [switch]>
  90.                  |                   |                         |
  91. Your uplink------|                   |                         |
  92.                                      |                         |
  93. Path/name of arealist of your boss---|                         |
  94.                                                                |
  95. Password set for areafix of your boss with switches------------|
  96.  
  97. Example:
  98.  
  99. #BOSSNODE   2:335/4.0@fidonet    FIDO:R/MM_AFIX/fidonet.LST   BIG   -l -q
  100. #BOSSNODE   39:102/1.0@amiganet  FIDO:R/MM_AFIX/amiganet.LST  KAJAS -l -q
  101. #BOSSNODE   9:395/102.0@virnet   FIDO:R/MM_AFIX/virnet.LST    GOOD  -l -q
  102.  
  103. The arealist where to find echoareas is a simple list of tagnames one by line.
  104.  
  105. Example:
  106.  
  107. ------- AMIGANET.LST ------
  108. NET2.AMY             Conferenza SysOp NET2
  109. Chatter.AMY          Chatter SysOp [AMY]
  110. SysOp_AMY            AmigaNet World SysOp Conference
  111. EMOD_AMY             Echomail moderators Support Conference
  112. Prova.AMY            Prova di Echomail [AMY]
  113. ---------------------------
  114.  
  115. ------ FIDONET.LST ------
  116. AUNIX.ITA          Conferenza UNIX
  117. MULTIMEDIA.ITA     Conferenza MULTIMEDIA
  118. TURBO_P.ITA        Conferenza TURBO PASCAL
  119. HANDHELD.ITA       Conferenza HANDHELD
  120. POLITICA.ITA       Conferenza POLITICA
  121. LAN.ITA            Conferenza LAN
  122. DESQVIEW.ITA       Conferenza DESQVIEW
  123. ATARI.ITA          Conferenza ATARI
  124. POINT.3354         Chatter POINT 3354
  125. CARTONI.ITA        Conferenza CARTONI
  126. FUMETTI.ITA        Conferenza FUMETTI
  127. SCOUT.ITA          Conferenza SCOUT
  128. DIRITTO.ITA        Conferenza DIRITTO
  129. -------------------------
  130.  
  131.  
  132.  
  133. #SPECIALNODE
  134. ~~~~~~~~~~~~
  135.  
  136. Your Special downlinks which have the chance to get echoareas NOT listed on
  137.  
  138. your system but present on your Boss system.
  139.  
  140. The right syntax is:
  141.  
  142. #SPECIALNODE <Node 5d> <MsgPath> <Your Address in that area> <MsgBase format> <Group> <Level>
  143.  
  144. Example:
  145.  
  146. #SPECIALNODE   2:335/202.1@fidonet     MSG:   2:335/202.0@fidonet    COMP   FidoNet_Italia  20
  147. #SPECIALNODE   2:335/227.0@fidonet     MSG:   2:335/202.0@fidonet    COMP   FidoNet_Italia  20
  148. #SPECIALNODE   2:335/229.0@fidonet     MSG:   2:335/202.0@fidonet    COMP   FidoNet_Italia  20
  149. #SPECIALNODE   2:335/234.0@fidonet     MSG:   2:335/202.0@fidonet    COMP   FidoNet_Italia  20
  150. #SPECIALNODE   2:335/210.0@fidonet     MSG:   2:335/202.0@fidonet    COMP   FidoNet_Italia  20
  151. #SPECIALNODE   39:102/109.0@amiganet   MSG:   39:102/101.0@amiganet  COMP   AmigaNet_Italia 20
  152.  
  153.  
  154.  
  155.  
  156. #POLICYPATH <Path>
  157. ~~~~~~~~~~~~~~~~~~
  158.  
  159. Path of Policy for AREAFIX and RAID
  160.  
  161. Remember to create inside <PATH> two others directories with the name RAID and AREAFIX
  162. where you must put the various policies.
  163.  
  164. Example:
  165.  
  166. #POLICYPATH MM:Config/Policy/
  167.  
  168.  
  169.  
  170.  
  171. #BANNER
  172. ~~~~~~~
  173.  
  174. The banner to insert in ALL areafix replies.
  175.  
  176. Syntax:
  177.  
  178. #BANNER <path/name>
  179.  
  180. Example:
  181.  
  182. #BANNER DLGConfig:Text/DIB.txt
  183.  
  184.  
  185.  
  186. #MESSAGE
  187. ~~~~~~~~
  188.  
  189. Configurable strings inside mm_areafix. You can translate them as you prefer...
  190.  
  191. Example:
  192.  
  193. #MESSAGE AREA_REQUESTED_TO_BOSS    Forwarding request to my UpLink
  194. #MESSAGE AREA_NOT_ECHO             This area is not an echo area
  195. #MESSAGE AREA_UNKNOWN              Unknown Area
  196. #MESSAGE AREA_UNLINKED             Area unlinked
  197. #MESSAGE AREA_YET_UNLINKED         Area not linked
  198. #MESSAGE AREA_NOT_AVAILABLE        This area is not available to you
  199. #MESSAGE AREA_LINKED               Area linked
  200. #MESSAGE AREA_LINKED_RESCANNED     Area linked and rescanned
  201. #MESSAGE AREA_YET_LINKED           Area already linked
  202. #MESSAGE AREA_YET_LINKED_RESCANNED Area already linked and rescanned
  203. #MESSAGE AREA_RESCANNED            Area rescanned
  204. #MESSAGE UNLINKED_LIST             List of all unlinked but available areas
  205. #MESSAGE AVAILABLE_LIST            List of all available areas
  206. #MESSAGE LINKED_LIST               List of all linked areas
  207. #MESSAGE MEANS_LINKED              * Means linked areas
  208. #MESSAGE ALL_CONNECTED             All available areas are already connected
  209. #MESSAGE NO_AREAS_CONNECTED        No area is connected
  210. #MESSAGE INACTIVE_ALL              Turn OFF all connected areas
  211. #MESSAGE INACTIVE_MESS             * To Reactivate Areas send a %ACTIVE to Areafix
  212. #MESSAGE ACTIVE_ALL                Activating all Inactive areas
  213. #MESSAGE NO_RESCAN_PTHRO           Passthrough Area, Not Rescaned
  214. #MESSAGE AVAILABLE_UPLINK          List of ALL available areas at my UPLINK
  215. #MESSAGE NO_AVAILABLE_UPLINK       Sorry, that list is NOT available
  216. #MESSAGE POLICY_NOT_FOUND          Sorry, Policy not available
  217.  
  218. The following are the configurable texts to put inside the messages created by mm_areafix.
  219.  
  220. ;
  221. ; Help sent when user ask for a help. Can be used the "embedded codes"
  222. ;
  223. ; Syntax: #HELP <help row>
  224. ;
  225. #HELP
  226. #HELP      Help on MM_Areafix+ commands:
  227. #HELP      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  228. #HELP
  229. #HELP    To use MM_Areafix you must send a message to Areafix , for messages
  230. #HELP  areas, and to RAID, for files areas.
  231. #HELP
  232. #HELP With this structure:
  233. #HELP
  234. #HELP From: You
  235. #HELP To  : AreaFix (Messages Areas) or RAID (Files Areas)
  236. #HELP Subj: <Password> [-L|-Q|-U|-H|-R|-FR]
  237. #HELP
  238. #HELP ======================================================================
  239. #HELP <*> Commands supported in the Subject line of the message
  240. #HELP
  241. #HELP -L  : List All Available Areas
  242. #HELP -Q  : List All Connected Areas
  243. #HELP -U  : List All Unlinked but Available Areas
  244. #HELP -H  : Send This Help
  245. #HELP -R  : Rescan (and Link) all Areas written in body of message
  246. #HELP -FR : Forced (and Link) Rescan of ALL messages in Areas written in body of message
  247. #HELP
  248. #HELP =======================================================================
  249. #HELP <*> Command supported in the body of the message:
  250. #HELP
  251. #HELP [+]<areaname>     - To Connect to an Area
  252. #HELP -<areaname>       - To Disconnect from an area
  253. #HELP
  254. #HELP %+ALL             - To Connect All Available Areas
  255. #HELP %-ALL             - To Disconnect All Linked Areas
  256. #HELP
  257. #HELP %INACTIVE         - To Temporarily Turn OFF all Areas 
  258. #HELP %ACTIVE           - To Turn any Inactive Areas Back On
  259. #HELP
  260. #HELP %LIST      or %L  - To request a List of Areas Avaiable to you
  261. #HELP %UNLINKED  or %U  - To request a List of Unlinked But Available Areas
  262. #HELP %QUERY     or %Q  - To request a List of all Connected Areas
  263. #HELP %HELP      or %H  - To request This Help screen
  264. #HELP %INFO      or %I  - Infos about your node
  265. #HELP %AVAIL     or %A  - To obtain the list of areas at my UPLINK
  266. #HELP
  267. #HELP ---               - Everything after this three dashes will be ignored
  268. #HELP =======================================================================
  269. #HELP MM_Areafix+ supports TWO types of Rescan:
  270. #HELP
  271. #HELP Simple Rescan: Rescan ONLY messages *WITHOUT* your node address in
  272. #HELP                the SEEN-BY
  273. #HELP Forced Rescan: Rescan ALL messages *IGNORING* the SEEN-BY lines
  274. #HELP
  275. #HELP <*> Available commands for the Rescan routine are:
  276. #HELP
  277. #HELP %RESCAN <area>                 or %R   - Simple Rescan <areaname> area
  278. #HELP %FORCERESCAN <area>            or %FR  - Forced Rescan of <areaname> area
  279. #HELP
  280. #HELP %RESCANDAYS <area> <days>      or %RD  - Normal Rescan of <x> days
  281. #HELP %FORCERESCANDAYS <area> <days> or %FRD - Forced Rescan of <x> days
  282. #HELP
  283. #HELP %RESCANALL                     or %RA  - Simple Rescan All linked areas
  284. #HELP %FORCERESCANALL                or %FRA - Forced Rescan of ALL messages in
  285. #HELP                                          ALL linked areas
  286. #HELP
  287. #HELP The Rescan routines are valid *ONLY* for messages areas
  288. #HELP ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  289. #HELP
  290. #HELP =======================================================================
  291. #HELP
  292.  
  293. ;
  294. ;  In all the reports and all the result string can
  295. ;  embedded some codes:
  296. ;
  297. ;   Embedded codes:
  298. ;
  299. ;   %FIRST     : Requesting Sysop's First Name
  300. ;   %NAME      : Requesting Sysop's Complete Name
  301. ;   %PASSWORD  : Password
  302. ;   %SYSOP     : Destination Sysop's Complete Name
  303. ;   %SYSOPNAME : Destination Sysop's first name
  304. ;   %ORIGNODE  : Originating Node
  305. ;   %DESTNODE  : Destination Node
  306. ;
  307. ;
  308. ;
  309. ; Message sent if the node is unknow. Embedded codes enabled.
  310. ;
  311. ; Syntax: #NODE_UNKNOWN <row>
  312. ;
  313. #NODE_UNKNOWN
  314. #NODE_UNKNOWN
  315. #NODE_UNKNOWN  Hello %FIRST
  316. #NODE_UNKNOWN 
  317. #NODE_UNKNOWN   today i received an areafix-request from you. The request failed because
  318. #NODE_UNKNOWN   at the moment you are not listed here.
  319. #NODE_UNKNOWN
  320. #NODE_UNKNOWN   Please contact me that we can solve the problem
  321. #NODE_UNKNOWN
  322. #NODE_UNKNOWN
  323. #NODE_UNKNOWN   Yours,
  324. #NODE_UNKNOWN
  325. #NODE_UNKNOWN  ** Sysop of DIB BBs **
  326. #NODE_UNKNOWN
  327. ;
  328. ; Message sent if the requestor has given a bad password.
  329. ; Embedded codes enabled.
  330. ;
  331. ; Syntax: #BAD_PASSWORD <row>
  332. ;
  333. #BAD_PASSWORD
  334. #BAD_PASSWORD
  335. #BAD_PASSWORD  Dear %FIRST
  336. #BAD_PASSWORD
  337. #BAD_PASSWORD   today i received an areafix-request from you but unfortunately you used
  338. #BAD_PASSWORD   a wrong password. The password "%PASSWORD" is not known here.
  339. #BAD_PASSWORD
  340. #BAD_PASSWORD   Please try it again with the right password or contact me if you have
  341. #BAD_PASSWORD   problems.
  342. #BAD_PASSWORD
  343. #BAD_PASSWORD   Sincerely yours,
  344. #BAD_PASSWORD
  345. #BAD_PASSWORD   %SYSOPNAME
  346. #BAD_PASSWORD
  347. ;
  348. #NOT_INACTIVE
  349. #NOT_INACTIVE
  350. #NOT_INACTIVE  Dear %FIRST
  351. #NOT_INACTIVE  
  352. #NOT_INACTIVE   It seems you haven't areas passivated.
  353. #NOT_INACTIVE
  354. #NOT_INACTIVE   If you think something has gone wrong feel free
  355. #NOT_INACTIVE   to contact my sysop %SYSOP
  356. #NOT_INACTIVE
  357. #NOT_INACTIVE   Sincerely your,
  358. #NOT_INACTIVE
  359. #NOT_INACTIVE   ** Sysop of DIB BBs **
  360. #NOT_INACTIVE
  361.  
  362.  
  363. ;-----------------------------------------------------------------
  364. ;   Embedded codes for NEW_AREA (CASE SENSITIVE):
  365. ;
  366. ;   %SPECIALNODE : Node
  367. ;   %TAGNAME     : Name of the Area
  368. ;   %ADDRESS     : Your Address
  369. ;   %PATH        : Path of the Area
  370. ;   %MESSAGEBASE : Message Base used for the area
  371. ;   %AREATYPE    : Type of the Area
  372. ;   %GROUPNAME   : Name of the Group
  373. ;   %GROUPLEVEL  : Access level
  374. ;------------------------------------------------------------------
  375. ;
  376. #NEW_AREA
  377. #NEW_AREA
  378. #NEW_AREA  Status:
  379. #NEW_AREA  -----------------------------------------------------------
  380. #NEW_AREA  Special Node                    : %SPECIALNODE
  381. #NEW_AREA  ----------------------------------------------------------
  382. #NEW_AREA  Name of the Area ...............: %TAGNAME
  383. #NEW_AREA  Your Address ...................: %ADDRESS
  384. #NEW_AREA  Area Path ......................: %PATH
  385. #NEW_AREA  Message Base ...................: %MESSAGEBASE
  386. #NEW_AREA  Area Type ......................: %AREATYPE
  387. #NEW_AREA  Group Name .....................: %GROUPNAME
  388. #NEW_AREA  Group Level ....................: %GROUPLEVEL
  389. #NEW_AREA  ------------------------------------------------------------
  390. #NEW_AREA
  391.  
  392.  
  393.  
  394. ;-----------------------------------------------------------------
  395. ;   Embedded codes for NODE_INFO (CASE SENSITIVE):
  396. ;
  397. ;   %ADDRDIM    : Dimension of the Seen-By/Path
  398. ;   %PACKDIM    : Dimension of the PKTs
  399. ;   %ECHOFLAVOR : Flavor of Echomail PKTs
  400. ;   %TICKFLAVOR : Flavor of Tick Files
  401. ;   %SESSIONPW  : Session Password
  402. ;   %PKTPW      : Packet Password
  403. ;   %AREAFIXPW  : AreaFix Password
  404. ;   %TICKPW     : Tick Password
  405. ;   %LISTGROUPS : List of all linked groups
  406. ;   %LISTECHOS  : List of all linked echoareas
  407. ;   %LISTTICKS  : List of all linked tickareas
  408. ;------------------------------------------------------------------
  409. ;
  410. #NODE_INFO  
  411. #NODE_INFO  ------------------------------------------------------------
  412. #NODE_INFO  Infos about your configuration
  413. #NODE_INFO  ------------------------------------------------------------
  414. #NODE_INFO  Dimension of the Seen-By/Path...: %ADDRDIM
  415. #NODE_INFO  Dimension of the PKTs...........: %PACKDIM
  416. #NODE_INFO  Flavor of Echomail PKTs.........: %ECHOFLAVOR
  417. #NODE_INFO  Flavor of Tick Files............: %TICKFLAVOR
  418. #NODE_INFO  Session Password................: %SESSIONPW
  419. #NODE_INFO  Packet Password.................: %PKTPW
  420. #NODE_INFO  AreaFix Password................: %AREAFIXPW
  421. #NODE_INFO  Tick Password...................: %TICKPW
  422. #NODE_INFO  ------------------------------------------------------------
  423. #NODE_INFO
  424. #NODE_INFO
  425. #NODE_INFO  You can access to the following groups
  426. #NODE_INFO  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  427. #NODE_INFO  %LISTGROUPS
  428. #NODE_INFO
  429. #NODE_INFO
  430. #NODE_INFO  List of EchoAreas Linked
  431. #NODE_INFO  ~~~~~~~~~~~~~~~~~~~~~~~~
  432. #NODE_INFO  %LISTECHOS
  433. #NODE_INFO
  434. #NODE_INFO
  435. #NODE_INFO  List of FileAreas Linked
  436. #NODE_INFO  ~~~~~~~~~~~~~~~~~~~~~~~~
  437. #NODE_INFO  %LISTTICKS
  438. #NODE_INFO
  439.  
  440.  
  441.  
  442.  
  443. * HOW TO CONTACT THE AUTHOR
  444. ---------------------------
  445.  
  446. You can contact Me at one of the following addresses.
  447.  
  448.  Paolo Carotenuto
  449.  FidoNet 2:335/202.0   - 2:335/228.0
  450.  AmigaNet 39:102/101.0 - 39:102/107.0
  451.  
  452.  ** This Programm is CardWare,  Please send your postcard to:
  453.  
  454.     Paolo Carotenuto
  455.     IV Trav. Perrone Capano 53/a
  456.     80126 - Pianura
  457.     Napoli ( Italy )
  458.  
  459.